home *** CD-ROM | disk | FTP | other *** search
/ Amiga Developer CD 2.1 / Amiga Developer CD v2.1.iso / NDK / NDK_3.1 / Examples1 / PCMCIA / AmigaXIP / AmigaXIP.ReadMe < prev    next >
Encoding:
Text File  |  1999-10-27  |  3.2 KB  |  81 lines
  1. PCMCIA AmigaXIP Execute-in-place code
  2. =====================================
  3.  
  4. (c) Copyright 1991-1999 Amiga, Inc.
  5. All Rights Reserved
  6. Preliminary
  7.  
  8.    THIS SOFTWARE AND INFORMATION IS COPYRIGHTED.
  9.  
  10.    THIS SOFTWARE AND INFORMATION MAY NOT BE REDISTRIBUTED, DISCLOSED,
  11.    OR DUPLICATED, IN WHOLE OR IN PART, IN ANY MANNER OTHER THAN AS
  12.    SPECIFIED IN A SIGNED AGREEMENT WITH AMIGA, INC.
  13.  
  14.    ************************************************************************
  15.    *                                      *
  16.    *                DISCLAIMER                  *
  17.    *                                      *
  18.    *   THIS SOFTWARE AND INFORMATION IS PROVIDED "AS IS".          *
  19.    *   NO REPRESENTATIONS OR WARRANTIES ARE MADE WITH RESPECT TO THE      *
  20.    *   ACCURACY, RELIABILITY, PERFORMANCE, CURRENTNESS, OR OPERATION      *
  21.    *   OF THIS SOFTWARE AND INFORMATION, AND ALL USE IS AT YOUR OWN RISK. *
  22.    *   NEITHER AMIGA NOR THE AUTHORS ASSUME ANY RESPONSIBILITY OR      *
  23.    *   LIABILITY WHATSOEVER WITH RESPECT TO YOUR USE OF THIS SOFTWARE      *
  24.    *   AND INFORMATION.                              *
  25.    *                                      *
  26.    ************************************************************************
  27.  
  28. loadc
  29. xipcode.asm
  30. loadseg.asm
  31.  
  32. Xipcode.asm is a minimal example of Amiga execute-in-place code for PCMCIA.
  33. The code contains a RomTag (struct Resident) and is assembled into
  34. an Amiga load file.
  35.  
  36. The loadc command can be used to loadseg "xipcode" to a not-in-use RAM
  37. credit card.  To do this you should boot without the RAM card,
  38. then use the PrepCard tool to format the card as system RAM.
  39.  
  40. Then do
  41.  
  42.     loadc xipcode
  43.  
  44. Loadc will add the appropriate PCMCIA tuples to identify the code
  45. as AmigaXIP (execute-in-place) code.  The system will InitResident the
  46. RomTag when you reboot the system.  The RomTag will be initialized right
  47. before strap (ie. all of the system will be up and running EXCEPT
  48. for intuition and dos).  Your code can open intuition, as shown in
  49. the example.
  50.  
  51. In the example xipcode.asm, if you press the left mousebutton on the demo
  52. screen, it will exit and the system will continue with the strap process
  53. (ie. system will attempt to boot from a bootable hard disk or floppy).
  54. A game, for example, might instead never return.
  55.  
  56. A value of TRUE (1) returned by AmigaXIP code signifies that the card is
  57. not removable (i.e. the card is in use, and system should be reset if the
  58. card is removed).  A value of FALSE (0) signifies that the card IS removable.
  59. If your AmigaXIP code exits, be sure to return the value 1 if the code
  60. or data in your card is still in use.
  61.  
  62. The "xipcode" program is linked with NO startup.asm code
  63. (blink from xipcode.o to xipcode library lib:amiga.lib), and is written
  64. so that it does not write to any variables in data or code space.
  65. This code could therefore run out of RAM or directly out of ROM.  If you
  66. need to loadseg your own code into system RAM in order to run, use the
  67. provided loadseg.asm code as an example of how to loadseg yourself.
  68.  
  69. Note that if a non-harddisk machine is turned on with no bootable
  70. disk or card inserted, any of the following can be inserted to
  71. satisfy the request for a boot disk:
  72.  
  73.     - bootable (installed) floppy
  74.     - AmigaXIP credit card
  75.     - bootable Amiga-disk credit card (use PrepCard and new
  76.         Install command provided on this disk)
  77.  
  78.  
  79. For more information on AmigaXIP and alternatives for PCMCIA code, read
  80. the PCMCIA.Software readme.
  81.